home *** CD-ROM | disk | FTP | other *** search
/ Developer Helper 1: Phil & Dave's Excellent CD / Excellent CD HFS.raw / Utilities / ResEdit / Examples / Instructions
Text File  |  2022-08-05  |  3KB  |  87 lines
  1. Instructions - The ResEdit Examples
  2.  
  3. Copyright Apple Computer, Inc. 1988
  4. All rights reserved.
  5.  
  6. These examples should be used with MPW 3.0.
  7.  
  8. About the Examples
  9.  
  10.     A sample resource editor, picker and LDEF are included with ResEdit.  These examples use
  11.     the MPW environment, the MPW C or Pascal compiler and the MPW Assembler.
  12.  
  13.     The example editor will simply display a window and invert its contents.
  14.     Since the details of editing your resource are known only to you, it is up 
  15.     to you to fill in the code necessary to make this into a real editor.
  16.     
  17.     The example picker is the actual ICON picker from ResEdit.  The ICON LDEF is
  18.     included with this example so that you can see the interaction between a picker
  19.     and its LDEF.
  20.     
  21.     The example LDEF is the general LDEF from ResEdit.  This LDEF is used to display a 
  22.     files resource list.  By looking at this LDEF and the one included with the ICON
  23.     picker, you can see two different ways of using custom LDEFs.
  24.     
  25. Building the examples
  26.  
  27.     You can build the examples using the build scripts provided in the
  28.     folder appropriate for the language that you are using.
  29.     
  30.     The build scripts assume that ResEdit and the Examples folder will be found 
  31.     in the directory {boot}ResEdit:.  If these files are located elsewhere, the
  32.     build script files should be modified accordingly.
  33.     
  34.     If ResEdit is successfully located, the MakeFile instructions will install
  35.     the editor, picker and LDEFs directly into ResEdit.  When you are experimenting
  36.     with changing any of these files, you may want to build into a copy of ResEdit.
  37.     In this way, if anything goes wrong, you can get a fresh copy of ResEdit for your
  38.     experiments.
  39.     
  40.     
  41. Files included in the example folders
  42.  
  43.  
  44.     BuildEditor, BuildPicker, BuildLDEF
  45.         The script files used to install the samples into ResEdit.
  46.         
  47.     MakeEditor, MakePicker, MakeLDEF
  48.         The Make files used by the build scripts.
  49.         
  50.         
  51. Files included in the Sources folder within the examples folder
  52.  
  53.     ResEd
  54.         The interface file used by all of the example files.  This file provides an
  55.         interface to procedures provided by the main ResEdit code.  The contents of this
  56.         file are described in the ResEdit manual.
  57.         
  58.     ResDisp.a
  59.         The assembly language interface between the editor or picker and the main
  60.         ResEdit code.  All of the procedures provided in the ResEd interface file
  61.         will be found in this module.  This file should be linked with all editors,
  62.         pickers and LDEFs.
  63.         
  64.     RSSC.a
  65.         The assembly language interface between ResEdit and your editor or picker.
  66.         This file should be linked with your editor or picker.
  67.         
  68.     LDEF.a
  69.         The assembly language interface between the list package and your LDEF.  This
  70.         file should be linked with your LDEF.
  71.         
  72.     ResXXXXEd
  73.         The main code for the editor.  This is the module that should be
  74.         modified to implement your editor.
  75.  
  76.     ICONPick
  77.         The ICON picker from ResEdit.  This file can be used as the starting point
  78.         for creating your own picker.
  79.         
  80.     ICONLDEF
  81.         The LDEF used by the ICON picker.
  82.         
  83.     GNRLLDEF
  84.         The general LDEF used to display a files resource list.
  85.  
  86.  
  87.